<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">

<html>
<head>
	<title>DX_ContextLab Readme</title>
	<style type="text/css">
	<!--
	body
	{
		font-family: Arial, Helvetica, sans-serif;
		color: black;
		background-color: white;
	}

	h1, h2, h3
	{
		border-bottom: 2px solid black;
		padding-bottom: 3px;
		padding-top: 10px;
	}

	ul>li
	{
		padding-bottom: 10px;
	}

	.warning
	{
		font-weight: bold;
		color: red;
	}
	-->
	</style>
</head>

<body>

<h1>DX_ContextLab</h1>

<h2>Description</h2>

<p>When working with DXCore Actions or other plugins, sometimes you need to enable, disable, or otherwise manipulate something based on whether a given context is satisfied. Unfortunately, it's hard to know what contexts are satisfied at any given time. That's where this plugin helps.</p>

<p>DX_ContextLab adds a tool window to the DevExpress\Diagnostics menu that you can set to poll every second for the complete list of contexts that are satisfied at any given time. It also adds a command ("Update Context Lab") that you can bind to a keyboard shortcut to manually refresh the list of satisfied contexts, should you not want polling to run.</p>

<h2>License</h2>

<p>Licensed under <a href="http://www.opensource.org/licenses/mit-license.php" target="_blank">the MIT License</a>.</p>

<p>Copyright 2009 Travis Illig</p>

<p>Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the "Software"), to deal
in the Software without restriction, including without limitation the rights
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
copies of the Software, and to permit persons to whom the Software is
furnished to do so, subject to the following conditions:</p>

<p>The above copyright notice and this permission notice shall be included in
all copies or substantial portions of the Software.</p>

<p>THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
THE SOFTWARE.</p>

<h2>Requirements</h2>

<p>This product requires <strong>DXCore for Visual Studio .NET 11.2 or later.</strong></p>

<p>DXCore is a free download from Developer Express, Inc.: <a href="http://www.devexpress.com/Products/Visual_Studio_Add-in/DXCore/" target="_blank">http://www.devexpress.com/Products/Visual_Studio_Add-in/DXCore/</a></p>

<h2>Installation</h2>

<p>There are two ways to install - Visual Studio Extension Manager or Manual Installation.</p>

<h3>Visual Studio Extension Manager</h3>
<p>In Visual Studio, go to <code>Tools -&gt; Extension Manager</code> and search for <code>DX_ContextLab</code>. Click the handy button to install.</p>

<h3>Manual Installation</h3>

<ol>
<li>Exit Visual Studio to ensure no files are locked.</li>
<li>Determine the location of your DXCore community plugin folder.</li>
	<ul>
	<li>This folder will most likely be a path like:</li>
		<ul>
		<li><tt>C:\Documents and Settings\YOURUSERNAME\My Documents\DevExpress\IDE Tools\Community\PlugIns</tt> <strong>OR</strong> </li>
		<li><tt>C:\Users\YOURUSERNAME\Documents\DevExpress\IDE Tools\Community\PlugIns</tt></li>
		</ul>
	<li>Your community plugin folder <strong>may have been reconfigured to be elsewhere</strong>. </li>
	<li>Its current location can be determined from the Core\Settings <a href="http://sites.google.com/site/coderushdocs/screens/options" rel="nofollow">options page</a>.</li>
	</ul>
<li>Put the DX_ContextLab.dll in your community plugins folder.</li>
<li>Right-click the plugin DLL, select &quot;Properties,&quot; and on the &quot;General&quot; tab, click the &quot;Unblock&quot; button. This is required to enable DXCore to properly execute the code in the plugin. </li>
<li>Restart Visual Studio.</li>
</ol>

<h2>Configuration</h2>
<p>There are no explicit configuration options; however, you may bind a key to the refresh action:</p>
<ol>
<li>Open Visual Studio.</li>
<li>From the DevExpress menu, select "Options," then "IDE/Shortcuts" from the treeview on the side.</li>
<li>Add a new shortcut.</li>
<li>Bind a key to the shortcut in the "Key 1" field ("Ctrl + Shift + Alt + U" is recommended).</li>
<li>Set the shortcut's command to "Update Context Lab".</li>
<li>Do not set any context for the shortcut. It should be allowed to run always.</li>
<li>Click "OK" to close the options window when you are done adding shortcuts.</li>
</ol>

<h2>Additional Info</h2>

<p>For more info, see the <a href="http://code.google.com/p/dxcorecommunityplugins/wiki/DX_ContextLab" target="_blank">DX_ContextLab wiki page</a> on the <a href="http://code.google.com/p/dxcorecommunityplugins/" target="_blank">DXCore Community Plugins site</a>.</p>
</body>
</html>
